home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pcbude11.zip / PCBUDE.DOC < prev    next >
Text File  |  1992-05-13  |  16KB  |  546 lines
  1.  
  2.  
  3.  
  4.  
  5.         ╓───────────────────────────────────────────────────────────╖
  6.         ║                                                           ║
  7.         ║             PCB  User Download Enforcer                   ║
  8.         ║               (A PCBoard  14.5a Door)                     ║
  9.         ║                                                           ║
  10.         ║                 PCBUDE  Version 1.1                       ║
  11.         ║                                                           ║
  12.         ║          Copyright (C) 1992 by David D. Casto             ║
  13.         ║                 ALL RIGHTS RESERVED                       ║
  14.         ║                                                           ║
  15.         ║               6196  Deewood Loop East                     ║
  16.         ║                Columbus, Ohio  43229                      ║
  17.         ║                   (614)  882-0994                         ║
  18.         ║                                                           ║
  19.         ╙───────────────────────────────────────────────────────────╜
  20.  
  21.  
  22.  
  23. Table Of Contents:
  24. =================
  25.  
  26.         Cover Page ..........................................  I
  27.         
  28.         Table Of Contents ................................... II
  29.  
  30.         Legal Information ...................................  1
  31.  
  32.         Registration ........................................  2
  33.  
  34.         Program Description .................................  3
  35.  
  36.         Quick Set Up ........................................  3
  37.  
  38.         Example Door Batch File .............................  4
  39.  
  40.         Example Config File .................................  5
  41.  
  42.         Config File Format ..................................  5 - 7
  43.  
  44.         Example Display File ................................  7
  45.  
  46.         Example From PCBSetUp ...............................  8
  47.  
  48.         Example $$LogOff.bat ................................  8
  49.  
  50.         Comments ............................................  9
  51.  
  52.         What's New ..........................................  9
  53.  
  54.  
  55.  
  56.    PCBUDE Version 1.1  -  PCBUDE.DOC  -  USER MANUAL               Page - II
  57. -----------------------------------------------------------------------------
  58.  
  59.  
  60.  
  61.                    PCBoard 14.5a User Download Enforcer
  62.  
  63.                            PCBUDE Version 1.1
  64.                    Copyright (C) 1992 by David D. Casto
  65.                           ALL RIGHTS RESERVED
  66.                         6196 Deewood Loop East
  67.                          Columbus, Ohio 43229
  68.                             (614)  882-0994
  69.  
  70.  
  71.  
  72.  WARNING!!
  73.  -------
  74.  
  75.       As with all new software it is *STRONGLY* recommended that
  76.  
  77.      you have a recent backup just in case.
  78.  
  79.  
  80.  Legal:
  81.  -----
  82.  
  83.        David Casto hereby disclaims all warranties relating to this
  84.  
  85.      software, whether express or implied, including without
  86.  
  87.      limitation any implied warranties of merchantability or fitness
  88.  
  89.      for a particular purpose. David Casto will not be liable for any
  90.  
  91.      special, incidental, consequential, indirect or similar damages
  92.  
  93.      due to loss of data or any other reason, even if David Casto or an
  94.  
  95.      agent of David Casto has been advised of the possibility of such
  96.  
  97.      damages.  In no event shall David Casto liability for any damages
  98.  
  99.      ever exceed the price paid for the license to use software,
  100.  
  101.      regardless of the form of the claim.  The person using the
  102.  
  103.      software bears all risk as to the quality and performance of the
  104.  
  105.      software.
  106.  
  107.        You are free to distribute this software as long as there are no
  108.  
  109.      modifications to any files in this Archive.
  110.  
  111.  
  112.    PCBUDE Version 1.1  -  PCBUDE.DOC  -  USER MANUAL               Page - 1
  113. -----------------------------------------------------------------------------
  114.  
  115.  
  116.  
  117.  
  118.  Registration:
  119.  
  120.       If you find PCBUDE easy, and convenient to use, a registration of
  121.  
  122.      $15.00 would be appreciated.  (See PCBUDE.REG)
  123.  
  124.       Registration includes:
  125.  
  126.        1) New updates to the software available for download from Blue
  127.  
  128.           Light BBS.
  129.  
  130.        2) User support also available on Blue Light BBS.
  131.  
  132.        3) A Key file that unlocks the Caller Log, Bulletin and Quiet Mode
  133.  
  134.           features downloadable from Blue Light BBS.
  135.  
  136.        4) The Key file also removes "Registered to UNREGISTERED"
  137.  
  138.           to "Registered to Your BBS and serial number".
  139.  
  140.        5) Your peace of mind knowing that you have done the right thing!
  141.  
  142.                Blue Light BBS is located in Columbus, Ohio
  143.  
  144.                       (614) 766-9708 14400 BPS
  145.  
  146.                       (614) 766-9709 19200 BPS
  147.  
  148.        *Note:  Please address all correspondence to David Casto when
  149.  
  150.                calling Blue Light BBS.
  151.  
  152.  
  153.  
  154.    PCBUDE Version 1.1  -  PCBUDE.DOC  -  USER MANUAL               Page - 2
  155. -----------------------------------------------------------------------------
  156.  
  157.  
  158.  What Is It? :
  159.  
  160.      PCBUDE is an "Auto-Log-In" door that will enforce file
  161.  
  162.      download limits per subscription.  Lets say your board
  163.  
  164.      is set up to allow 800 files per subscription and Joe
  165.  
  166.      User has already downloaded 800 files, the next time he
  167.  
  168.      logs onto the board his security will be reset to a temp-
  169.  
  170.      orary sub-expired level until he either re-subscribes or
  171.  
  172.      expires.  His file upload and download amounts can be set
  173.  
  174.      to zero ready for re-subscription or left as they are.
  175.  
  176.      PCBUDE will show your display file to the caller and make a
  177.  
  178.      PCBStuff.KBD to force the caller to do what ever you want when
  179.  
  180.      PCBoard reloads.
  181.  
  182.  
  183.  Setup:
  184.  
  185.    1.) Make a directory for PCBUDE and place all PCBUDE's files in
  186.  
  187.        it.  I call mine PCBUDE and will use this in the examples.
  188.  
  189.    2.) Place a door batch file for each node in the C:\PCBUDE
  190.  
  191.        directory (see batch file examples).
  192.  
  193.    3.) Place and Edit a PCBUDE(x).CFG (or any Path\FileName) file in a
  194.  
  195.        directory.  Use a different FileName for each node (PCBUDE1.cfg
  196.  
  197.        PCBUDE2.cfg etc).
  198.  
  199.    4.) Place and edit a PCBUDE.TXT (or any Path\FileName) in a directory
  200.  
  201.        (see example).
  202.  
  203.    5.) Set up PCBUDE in PCBSetUp (see example).
  204.  
  205.    6.) Put a $$LogOff.bat file in each node(s) directory (see example).
  206.  
  207.    7.) See sample CALLER1 and PCBUDE.BLT files for examples of the BLT
  208.  
  209.    and Caller features.
  210.  
  211.    8.) Please let me know if you like PCBUDE!
  212.  
  213.  
  214.    PCBUDE Version 1.1  -  PCBUDE.DOC  -  USER MANUAL               Page - 3
  215. -----------------------------------------------------------------------------
  216.  
  217.  
  218.  
  219. Example Door Batch Files For Node 1:
  220. ===================================
  221.  
  222.       --------------------------
  223.        Regular Door Batch File:
  224.       --------------------------
  225.             ECHO OFF
  226.             C:
  227.             CD\PCBUDE
  228.             PCBUDE C:\PCB\PCBUDE1.CFG
  229.             CD\PCB
  230.             BOARD
  231.  
  232.       ------------------------
  233.        Shell Door Batch File:
  234.       ------------------------
  235.             ECHO OFF
  236.             C:
  237.             CD\PCBUDE
  238.             PCBUDE C:\PCB\PCBUDE1.CFG
  239.             CD\PCB
  240.             EXIT
  241.  
  242.       --------------------------------------------------
  243.        Regular Door Batch File using PCBoard variables:
  244.       --------------------------------------------------
  245.             ECHO OFF
  246.             C:
  247.             CD\PCBUDE
  248.             PCBUDE C:\PCBUDE\PCBUDE%PCBNODE%.CFG
  249.             C:
  250.             CD\%PCBDIR%
  251.             BOARD
  252.  
  253.       ------------------------------------------------
  254.        Shell Door Batch File using PCBoard variables:
  255.       ------------------------------------------------
  256.             ECHO OFF
  257.             C:
  258.             CD\PCBUDE
  259.             PCBUDE C:\PCBUDE\PCBUDE%PCBNODE%.CFG
  260.             C:
  261.             CD\%PCBDIR%
  262.             EXIT
  263.  
  264.  
  265.  
  266.    PCBUDE Version 1.1  -  PCBUDE.DOC  -  USER MANUAL               Page - 4
  267. -----------------------------------------------------------------------------
  268.  
  269.  
  270. Example PCBUDE(x).CFG:
  271. =====================
  272.  
  273.  
  274.        *Must contain this format (WITHOUT line comments)!
  275.         ------------------------------------------------
  276.  
  277.  
  278.  
  279. c:\pcb\pcboard.sys       <---- Path to PCBoard.sys
  280. Blue Light BBS           <---- Board Name
  281. David                    <---- Sysop First Name
  282. Casto                    <---- Sysop Last Name
  283. c:\pcb\main\users        <---- Path\File Name of USERS
  284. c:\pcbude\pcbude.txt     <---- Path\File Name of Display File
  285. c:\pcb                   <---- Path to this node
  286. B;2                      <---- Command PCBoard will execute
  287. c:\pcbude\pcbude.blt     <---- Path\File Name of BLT (or NO)
  288. c:\pcb\main\Caller1      <---- Path\File Name of Callers log (or NO)
  289. c:\pcbude\pcbude.log     <---- Keep a Log of downgrades (Yes or No)
  290. 23                       <---- Max Line Length of BLT
  291. No                       <---- Run in Quiet Mode (Yes or No)
  292. Yes                      <---- Zero out file up/down fields
  293. 2                        <---- Number of Data Lines
  294. /S105/U200/D400/N30      <---- Data Line 1
  295. /S100/U100/D200/N30      <---- Data Line 2
  296.  
  297.  
  298.  
  299.           Line 1 is the Path\FileName of the PCBoard.sys file.
  300.  
  301.           Line 2 is the name of your BBS.
  302.  
  303.           Line 3 is the SysOp first name.
  304.  
  305.           Line 4 is the SysOp last name.
  306.  
  307.           Line 5 is the Path\FileName of the USERS file.
  308.  
  309.           Line 6 is the Path\FileName of the time limit Display File
  310.  
  311.         you want displayed to the caller if their security will be
  312.  
  313.         adjusted (see example PCBUDE.Txt).
  314.  
  315.           Line 7 is the Path to the Node Directory.
  316.  
  317.           Line 8 is the command PCBoard will "Stuff" into the key
  318.  
  319.         board buffer and be executed when PCBUDE returns the user
  320.  
  321.         to the board.  You may leave this line blank if you do not
  322.  
  323.         want to use this option.
  324.  
  325.  
  326.    PCBUDE Version 1.1  -  PCBUDE.DOC  -  USER MANUAL               Page - 5
  327. ----------------------------------------------------------------------------
  328.  
  329.  
  330.           Line 9 is the BLT Path\FileName of a BLT file to display
  331.  
  332.         a quick view of PCBUDE's File Limit activity without
  333.  
  334.         displaying the Caller(x) log.  To disable this feature place
  335.  
  336.         NO on this line.
  337.  
  338.         (You need a Registered Key file to unlock and use the BLT
  339.  
  340.         feature.)
  341.  
  342.           Line 10 is the Caller(x) log Path\FileName.  PCBUDE will
  343.  
  344.         append to the CALLER(x) log all security level adjustment
  345.  
  346.         activities.  To disable this feature place NO on this line.
  347.  
  348.         (You need a Registered Key file to unlock and use the Caller
  349.  
  350.         log feature.)
  351.  
  352.           Line 11 is the Path\FileName of a log of all down grades.
  353.  
  354.         To disable this feature place NO on this line.
  355.  
  356.           Line 12 is the Maximum lines to allow your BLT(s) to be
  357.  
  358.         before PCBUDE will delete it and start a new one.
  359.  
  360.           Line 13 is for Quiet Mode.  Place YES on this line to run
  361.  
  362.         under Quiet mode.  Quiet Mode will just display "PCBUDE
  363.  
  364.         Version XX.X" and limit the text displayed to the user.
  365.  
  366.         Quiet mode will display your display file to the caller if
  367.  
  368.         they have reached their maximum downloads and their security
  369.  
  370.         level has been adjusted.
  371.  
  372.         (You need a Registered Key file to unlock and use the Quiet
  373.  
  374.         Mode feature.)
  375.  
  376.           Line 14 is Zero out the file up/down fields in the user
  377.  
  378.         record.  YES will Zero out these fields and NO will leave
  379.  
  380.         them as they were.
  381.  
  382.           Line 15 is the number of data lines  to follow.  PCBUDE
  383.  
  384.         will only read this many lines even though there could be
  385.  
  386.         more in the file.
  387.  
  388.           Line 15 thru 16 are the data lines.  You may have as many
  389.  
  390.         data lines as you like however, line 14 must reflect how
  391.  
  392.         many to read.
  393.  
  394.  
  395.    PCBUDE Version 1.1  -  PCBUDE.DOC  -  USER MANUAL               Page - 6
  396. -----------------------------------------------------------------------------
  397.  
  398.  
  399.  
  400.       Format of Data Lines:
  401.       --------------------
  402.  
  403.  
  404.    /S105                 <---- Security Level to act upon
  405.  
  406.    /U200                 <---- Uploads needed to abort auto change
  407.  
  408.    /D400                 <---- Download Max to allow
  409.  
  410.    /N30                  <---- New security level
  411.  
  412.             Check all users with a security level of 105
  413.  
  414.             If user has uploaded 200 or MORE files then ABORT
  415.  
  416.               security level change.
  417.  
  418.             If a user has downloaded 400 or more files then
  419.  
  420.               downgrade user to the new security level.
  421.  
  422.             Give the new security level of 30 to the user.
  423.  
  424.  
  425.  
  426.  
  427.  
  428. Example PCBUDE.TXT:
  429. ==================
  430.  
  431.  
  432. @CLS@
  433.    @X0D-----------------------------------------------------------------
  434.  
  435.                             @X0CPlease Note@X0F
  436.  
  437.             Your download limit has been reached and your Security
  438.            Level has been reduced.  We would like to thank you for
  439.            your continued support.
  440.  
  441.                              Thank You
  442.                                SysOp
  443.  
  444.  
  445.    @X0D-----------------------------------------------------------------
  446.  
  447.  
  448.  
  449.    PCBUDE Version 1.1  -  PCBUDE.DOC  -  USER MANUAL               Page - 7
  450. -----------------------------------------------------------------------------
  451.  
  452.  
  453.  
  454.  
  455. Example from PCBSetup:
  456. =====================
  457.  
  458.  
  459.  The following example will send all users with a security level
  460.  
  461.  of 50, 52, 53, 54 into PCBUDE.
  462.  
  463.                           Edit DOORS File
  464.  
  465.                               USER DOOR
  466.  Filename    Password    Sec Login SYS  SYS  Shell   Path to DOOR Files
  467. ══════════ ═════════════ ═══ ═════ ════ ════ ═════ ══════════════════════
  468. 1) PCBUDE                 50   Y    N    N     Y  C:\PCBUDE\
  469. 2) PCBUDE                 52   Y    N    N     Y  C:\PCBUDE\
  470. 3) PCBUDE                 53   Y    N    N     Y  C:\PCBUDE\
  471. 4) PCBUDE                 54   Y    N    N     Y  C:\PCBUDE\
  472.  
  473.  
  474.  
  475.  
  476.  
  477. Example $$LogOff.bat:
  478. ====================
  479.  
  480.  
  481.     if exist pcbstuff.kbd del pcbstuff.kbd
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.    PCBUDE Version 1.1  -  PCBUDE.DOC  -  USER MANUAL               Page - 8
  489. -----------------------------------------------------------------------------
  490.  
  491.  
  492. Comments:
  493.  ========
  494.  
  495.           PCBUDE was constructed due to a need on Blue Light BBS
  496.  
  497.         in Columbus Ohio.  PCBUDE was written as an "auto-log-in"
  498.  
  499.         door due to way too much down time to run all the applicat-
  500.  
  501.         ions during the system event.  As an "auto-log-in" door
  502.  
  503.         PCBUDE will save time by doing an on-line downgrade at
  504.  
  505.         that time and explaining to the user why they have been
  506.  
  507.         down-graded.
  508.  
  509.           *If* you have any problems installing PCBUDE or any of
  510.  
  511.         my doors feel free to call me voice ( 614-882-0994 ).  I
  512.  
  513.         also monitor the DOOR and UTILITY conferences on Salt Air.
  514.  
  515.        *Note:  Please address all correspondence to David Casto when
  516.  
  517.                calling Salt Air or Blue Light BBS.
  518.  
  519.  
  520.  
  521.  
  522.  
  523. What's NEW:
  524. ==========
  525.  
  526.  
  527.       Version 1.0
  528.       -----------
  529.  
  530.                 Initial release.
  531.  
  532.  
  533.       Version 1.1
  534.       -----------
  535.  
  536.             Added - Option to zero out files up/downloaded to
  537.                     the config file.
  538.             Added - Quiet mode is now true quiet mode.  Now in
  539.                     quiet mode the only thing the user will see
  540.                     is the Display file *IF* it exists.
  541.             Fixed - Format of the caller log.
  542.  
  543.    PCBUDE Version 1.1  -  PCBUDE.DOC  -  USER MANUAL               Page - 9
  544. -----------------------------------------------------------------------------
  545.  
  546.